/*!1560w
                       MAKING A FORM

  Click Right Mouse Button to pop up menu or submenu.

  Press Left Mouse Button to:

      1. Select a menu entry
      2. Toggle line drawing corner, edge, etc.
      3. Draw a box, with cursor at lower right corner

  Hold Left Mouse Button Down to:

      1. Draw lines and data entry fields
      2. Paint with selected color
      3. Erase lines, data entry field or color

  Press <Esc> Key to (optionally) save form and exit.

  Press <F2> key when in Data Definitions Mode, to
  insert or delete field definition entries.


  Main Pop-up Menu Selections:

    1 DRAW LINES OR DATA ENTRY FIELD
      (Mouse left button down)

      1.1 Draw single, double and special character lines
      1.2 Draw (identify) data fields



    2 POSITION CURSOR AND ENTER TEXT

      2.1 Position cursor
      2.2 Edit form (line inserts/deletes, etc.)
      2.3 Enter field labels and other text

    3 ERASE COLOR OR LINES
      (Mouse left button down)

      3.1 Erase bakground or foreground color
      3.2 Erase lines
      3.3 Erase data entry fields

    4 MAKE CORNER, EDGE, OR INTERSECT

      Toggle mouse left button to select a graphic

    5 PAINT BACKGROUND COLOR
      (Mouse left button down)

    6 PAINT FOREGROUND COLOR
      (Mouse left button down)

    7 MAKE A BOX

      Position to the top left corner of the box BEFORE
      selecting. Position to the bottom right corner of
      the box to be drawn and press mouse left button.


    8 REMOVE THE BOX

      Remove the last box created in selection 7.

    9 CONTROL SCREEN BACKGROUND

      9.1 Keep lines/colors stationary as text is moved

      9.2 Allow lines/colors to move with text

      9.3 Change temporary background color


    D DEFINE DATA ENTRY FIELDS

      Data entry fields must have been previously drawn.

      The cursor is positioned to the first field be
      defined, and the data definition menu appears.

      Select a Field Type and press Left Mouse Button.

          Field Types:

             TEXT
             TEXT UPPERCASE
             NUMERIC LEFT JUSTIFIED
             NUMERIC RIGHT JUSTIFIED
             NUMERIC ALIGNED TO DECIMAL POINT
             NUMERIC EDITED IN $ FORMAT
             DATE
             PHONE NUMBER
             SOCIAL SECURITY NUMBER
             PASSWORD

      A temporary background/foreground color combination
      quickly identifies each field type.

      Field line, column and size are automatically
      determined.

      Press right mouse button to pop-up submenu that
      permits data entry field attributes to be entered.
      CAUTION: You will be modifying a 'C' structure;
               structure syntax rules must be observed.

      Enter Field Attributes:

          -  Field Name

          -  Background and foreground field colors

          -  Relative cursor movement, replace defaults:

                CUP    (-1)
                CDOWN  (+1)
                CLEFT  (-1)
                CRIGHT (+1)

          -  MUST_ENTER_OFF or MUST_ENTER_ON

          -  MUST_FILL_OFF or MUST_FILL_ON

          -  PROTECT_OFF or PROTECT ON (no data entry)

          -  ZERO_FILL_OFF or ZERO_FILL_ON

          -  FLOAT_LINE_OFF or FLOAT_LINE_ON (uses AL)

          -  PRE_EDIT_OFF or PRE_EDIT_ON

          -  AUTO_HELP_OFF or AUTO_HELP_ON

          -  IGNORE_OFF or IGNORE_ON (ignore entry)

          -  Name of user field edit function in program
             PRE_EDIT_OFF/PRE_EDIT_ON and AUTO_HELP_OFF/
             AUTO_HELP_OFF variables can be tested in
             your user field edit routine.

       Press 'Page Down' and enter a help message for
       the field.

       CAUTION: You are entering 'C' structure data
       elements; structure syntax rules must be observed.
       Otherwise, your program will have compile errors.

       Press Right Mouse Button to return to main menu.

       Select NEXT FIELD (or press 'n') to advance to
       next data entry field.

       Select PREVIOUS FIELD (or press 'p') to move to
       previous data entry field.

       Select CANCEL to exit the Data Definition Menu.

       Note: Selecting the DEFINE DATA ENTRY FIELDS entry
             makes the form a data-entry form, as opposed
             to a display-only form.

       Press F2 to pop up the submenu if you need to
       insert, clear or delete a field definition.

       A header file (*.h), with the same name as the
       form, is created when the form is saved. The
       header file is an array of C structures that
       define data entry field attributes. It must be
       included (as an #include file) in programs that
       use the form for data entry. Multiple header
       files can be included in the same program.


  A Data-Entry Form implies that one or more header
  files are included in the program that uses that form.
  The DEFINE DATA ENTRY FIELDS causes a header file to
  be generated.

  An ICON Form is created when the form name is either
  one character long, or two characters long with the
  second character equal to 'U'(uppercase).

  ICON Forms are converted to graphic ICONS, and displayed
  when its corresponding (lower or uppercase) key is
  pressed during MAKING AN OVERLAY and ICON Mode in effect.

  For a ONE character ICON field name:

     When a lower-case key corresponding that name is
     pressed during MAKE AN OVERLAY, the ICON is inserted
     at the LAST selected screen position. For example,
     if form '1.frm' exists, its icon will be inserted
     when the '1' key is pressed.

  For a TWO character icon field name:

     The second character must be 'U', which denotes
     denotes uppercase for the first character.
     For example, if a ICON Form name is 'AU.FRM', then
     that icon will be displayed when the uppercase 'A'
     key is pressed during MAKE AN OVERLAY (and ICON MODE
     enabled).

     When a new ICON Form is created, a template is
     copied to the new ICON Form. An ICON is created by
     painting the ICON template with selected foreground
     colors.

  Graphics Forms

     A graphics form is created in the same way as a
     text form, except that a graphics form is 30 lines
     instead of 25 lines. Both Text and Graphics forms
     can be converted to overlays, but it is best to
     create a graphics form if it is to be combined with
     an overlay.








END OF FORM.HLP
